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PHINT s 


BUILD P HELPFUL HINTS 


This paper describes helpful hints on how to use build P of 
NOS/VE. It is intended to supplements rather than to replaces 
the standard NOS/VE documentation. If you have any aqustions or 
suggestionss please see Tom McGee or Bonnie Swierzbin. Appendix 
A tists background documents and how to obtain them. 


To obtain additional copies of this document while running on 
SN101 at Arden Hiliss please type: 


SESsDEVI.LISTPH C=<number of copies> 


To obtain a copy with revision bars against the Helpful Hints of 
the previous builds please type: 


SESsDEV1L.~LISTPH REVB C=<number of copies> 


The C parameter is optional and defaults to one. 


Yodate History 

Date Changes 

12/22/80 Revisions for NOS/VE Phase C 

2/12/81 Additional revisions for NOS/VE Phase C 
6/9/81 Revisions for NGS/VE Build N 

6/19/81 Additional revisions for NOS/VE Build N 
8/28/81 Revisions for NOS/VE Build 90 

11/6/81 Revisions for NOS/VE Bulld P 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


o Atl existing commands have been updated to Revision 8 of the 
ERS. In additions parameter abbreviations have been added for 
allo commandse This invotved some renaming of parameters from 
what was previously implementeds and in some casess from what 
was described in the ERS. 


A description of the parameter names that have been changed 
and the algorithm for deriving the abbreviations can be found 
in the COMMAND INTERFACE STATUS section of this document. 


o The tong awaited message generator is availabite! Henceforths 
in most casess rather than a condition code and raw status 
record texts you will see formatted messages and their 
designated severity. The exceptions will be for any remaining 
HCS condition codes ands of courses conditions for which no 
message templates have been defined. Feedback with regard to 
the intelligibility and usefulness of the messages you 
encounter would be greatly appreciated. comments on this 
subject should be given to CG. Neftson (ARH263»5 X2750) 
preferably in writing. 


When a job is initiated» the message mode is set to brief. 
This means that the Identifier and condition code for a 
message will not be shown; ieee you will only see a severity 
designator and aie formatted message; the severity designator 
for informative messages is omitted. If you really want to 
see the condition codes use the SET_MESSAGE_MDDE FULL 
command. In full mode the severity designator for informative 
messages is inctuded. 


0 Interactive Usage Restrictions: When togging in to NOS/VE 
(hee@0e HELLOsTAF etc.) do not enter a terminate break (CTRL 
t) or a#pause break (CTRL 9) before the ‘welcome message't 
appears at the terminal. A pause or terminate break entered 
before the inter active NOS/VE job has completed it's 
initialization may crash the system. 


A REQUEST_LTERMINAL command in a batch job will crash the 
system. This can happen accidently through a REQUEST_TERMINAL 
command in a user prolog when the user runs a batch job since 
the prolog is executed for both interactive and batch jobs. 
The problem can be avoided by making the REQUESTLTERMINAL 
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command in the protog conditional on the job type as follows: 


IF $JOB(MODE) <> *BATCH*® THEN 
REQUEST_TERMINAL 
IFEND 


o The LOGIN and LOGOUT commands have been implemented. This 
includes the processing of system and user prologs 9 and 
epilogs. Since prolog processing Is now done automatically at 
fogins the SETUP command has been defeted. The default for 
the FAMILY_NAME parameter is inherited from the submitting job 
rather than set to an operator provided default as specified 
in the ERS. 


The system protog consists of processing the S$SSYSTEM.»SYSPROF 
file as was done previousty by SETUP.» If any errors occur 
during system prolog processings the user job is aborted in 
both Interactive and batch modes. 


User prolog processing consists of attempting to attach a file 
called PROLOG in the $USER catalog. If unsuccessful» an 
attempt is made to get the file PROLOG from the user's 1706 
catalog; if this is successfuls the file is saved in the $USER 
catalog for subsequent accesses. If the file PROLOG is now 
availables it is INCLUDEd; otherwise nothing further is done. 
If any errors occur during user prolog processings batch jobs 
are aborted and interactive jobs continue. 


User epilog processing consists of the same steps as user 
prolog processing except that the file involved is EPILOG and 
if errors occurs processing continues with the system epilog. 


The system epitog is an empty procedure for the time being. 


LOGIN automatically issues a LINK _USER command for the user 
flogging ine In additions LINK _USER now works as documented in 
the ERS» that is issuing a LINK USER after togin changes the 
job setting rather than aborting. 


0 The contents of the SSYSTEM catalog can be displayed using the 
DISPLAY_CATALOG S$SYSTEM command. 


o Up until now if an error occurred at the "first level" in 
batch jobs (i.e. the command came from the file COMMAND) the 
error was reported and the job continued processing commands. 
This is no fonger true; an error at the first level will cause 
batch jobs to be aborted. 


The fite SRESPONSE is no tonger connected to the file OUTPUT 
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in batch jobse The CONNECT_FILE command may be used to make 
this connection if desired. 


The “Welcome to NOS/VE eee" banner is no longer written to 
S$RESPONSE. It is now written to OUTPUT and ontiy in 
interactive jobs (i.e. not in batch or console jobs). 


o The GETLFILE and REPLACE_FILE commands have been implemented 
and they take the place of the procedures that were availablie 
in previous builds. The HCS GET and REPLACE commands have 
been withdrawn. 


o Permanent file catalogs and object ftibraries can be included 
in the command tist via the SET_COMMAND_LIST command. Both 
SCL procedures and program descriptions can be directly 
executed with the necessary files being autonatically 
attached, 


o In PROC dectarationss FILEREF is no tonger a valid SCL 
parameter type. The FILE specification should be used instead 
and is the default. 


Also the APPLICATION specification has been changed from: 
APPLICATION <sp> <application value procedure name> 
to: 
<apptlication value name [<sp> <application value procedure 
name>] 


o The DISPLAY _FILEUSTATUS command has been renamed to 
DISPLAY _PRINT_STATUS. 


o The CATALOG parameter for the DISPLAY_CATALOG command now 
defaults to the working catalog rather than being required. 


| o The new version of DISPLAY_LOG has the following parameters: 


DISPLAY_LOG DISPLAY_OPTIONS: DISPLAY_OPTIOQNs DG: INTEGER or 
KEY alts ftast=all 
OUTPUTs O=Soutput 
STATUS | 


The parameters are defined as documented in the command 
interface, howevers regardiess of the number of fines 
requested to be displayeds only the last tine is disotayed. 
The TYPE parameter has been removed. DISPLAY_LOG can only 
display the userts job tog. 


o CLPSPUT_LSTND_OUT has been deleted. Calls to CLPSPUT_STND_OUT 
should be replaced by calls to either CLPSPUT_JOB_DUTPUT (deck 
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CLXOUT) or CLPSPUT_JOB_COMMAND_RESPONSE (deck CLXRESP) which 
will write to the files OUTPUT and $SRESPONSE respectively. 


o The modifications made to the type pmt$program_description 
(deck PMDPRGX) require that users of PMPSEXECUTE recompile. 


© In addition to the renaming of parameters and adding all 
parameter abbreviations that occurred in this builds the 
command names will be renamed as well. In this build the only 
commands that have been reimptemented in their new form are 
the subcommands for the CREATE_OBJECT_LIBRARY utility. The 
new subcommands are documented in the new version of the 
command interface. To obtain a copy of the new command 
interface for CREATE_GBJECT_LIBRARY simply type 
SESsMADeLISTNCI S$#=11 on SN101 at Arden Hills. 


The of d subcommands for the library generator are supported as 
well as the new subcommands.e The oniy Incompatiblity with the 
old ERS is the removal of the I parameter from the 
CREATE_OBJECT_LIBRARY command. The equivalent capability can 
be realized by calling CREATE_LOBJECT_LIBRARY and doing = an 
INCLUDE on the file that would have been specified with the I 
parameter. 


The new parameter names and abbreviations can be determined by 
using the DISPLAY _COMMAND_INFORMATION command. 


o Any product or utitity that is placed in the $SYSTEM catalog 
(or any frequently loaded program) should be bound using the 
CREATE _ MODULE subcommand of the CREATE_OBJECT_LIBRARY 
utility. This will minimize overhead associated with toading 
the product or utility. 


o The PMPSGENERATE_UNIQUE_NAME program interface has been made 
available. This is of particular importance to all utilities 
and products that use names for intermediate files or tocal 
queues; uniaue names should be used for these names to attow 
successful asynchronous execution of the utility or product. 


o Date and time are now copied across from NOS at every 
deadstart. 


o Debug responds to terminal breaks when a program Is being 
debugged. Howevers entering a pause or terminate break when 
debug is active (Jee. the DB/ prompt has appeared and the 
user has not Issued the RUN command) will cause the task to 
terminate. 


o Permanent Files still are permanent only until a crash or 
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deadstart. 


o You can cause SCL to output the commands being executed from a 
-procedure or include file by doing: 


connect_file $ECHO OUTPUT 


o When sharing executable files via permanent files (ise. 
compilerss librariess etc.) you should make the file an 
object tfibrary via the CREATE_GBJECT_LIBRARY utility. By 
sharing object libraries instead of object filess the code is 
actually shared among afl tasks using the Jibrarys the library 
is not copied to another segment but is executed directly. 


90 The fite{s) specified by the FILE parameter on the EXECUTE 
command may not be object library files. - 


o The program option PRESET now works. 


lel NOSZVE_USAGE EXAMPLES 


Llelel EXECUTING PROGRAMS 


LIMITATIONS 


~ The fite(s) specified by the FILE parameter on the EXECUTE 
command may not be object itibrary files. 


PROCESS 


Create an object text file by compiling a program on NOS. Then 
perform the following steps on NOS/VEs 


- Acquire any necessary Jibraries (which are not quoted in text 
embedded directives) by either: 


o Attaching them from the system catalogs either explicitiy 
or via prolog 
or 
o Creating the tibrary file via the object fibrary generator 
or 
0 Staging the tfibrary file from NGS to NOS/VE using the 
GET_FILE command with B56 conversion mode specified. 


- Get the file from NOS and convert the object text file from 


Build P» November 1981 


NOS 


we a0 


1-6 
/VE Build P helpful hints 
12/22/81 


1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


1.1 


° EXECUTING PROGRAMS 


the CI data mapping to II data mapping by executing the 
CONVERT_LOBJECT_FILE command. 


- Load and execute the program via the EXECUTE commands 
specifying the necessary iibraries with the LIBRARY parameter; 
alternatively SETLOBJECTLLIST may be used to inctude the 
fibraries in all subsequent EXECUTE commands. 


- Stage the loadmap from NOS/VE to NOS for printing by using 
either: 


0 The REPLACE_FILE command with A6 conversion mode specified 
if running on the simulator. 
or 
o The PRINT command if running on the hardware. 


EXAMPLES 


The following is an exampie command sequence for executing a 
program not requiring any tibraries for toadings 


Assumptions: all modules to be loaded are contained on the NOS 
permanent file ‘'citxtrs!?,. 


CONVERTLOBJECT_FILE CITXTRS 
EXECUTE CITXTRS PARAMETER" program parameters? 
PRINT LOADMAP 


The following is an example command sequence for executing a 
program requiring libraries for loading: 


Assumptions: the NOQS permanent file ‘citxtrs'! contains object 
text generated by the CYBIL CI compiter. The compiler modules 
reference procedures contained on the user library ‘myfib*® and 
the CYBIL run-time ltibrary. These tibraries have been generated 
on NOS/VE and saved on NOS. 


GETLFILE MYLI8B DC=B856 

SETUPROGRAM_OPTIONS LOAD LMAP_OPTIONS=(BLOCKsENTRY_POINTs SEGMENT) 
CONVERT_LOBJECT_FILE CITXTRS 

EXECUTE CITXTRS *program parameters! LIBRARY=MYLIB 

PRINT LOADMAP 


1e-1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 


Notes: 
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CLGO170 is NOS permanent file name for fite containing CI 
object text for modules to be included in the library. 


IITEXT180 ts NOS/VE tocal file name for file containing II 
object text for modules to be included in the library. 


LIBRARY180 is NOS/VE focal file name for the tibrary heing 
createde 


ILIB170 is NOS permanent file name for file containing the 
library. 


NOS/VE Job Commands 


CONVERTLOBJECTLFILE LITEXT180 CLGO170 
CREATEOBJECT LIBRARY 

ADD_MOQDULE LIBRARY=ITITEXT180 
GENERATE_LIBRARY LIBRARY=LIBRARY180 
QUIT 

REPLACE_FILE LIBRARY180 ILIB170 DC=856 


1e1.3 MODIFY A PREVIGUSLY SAVED OBJECT LIBRARY 


Notes 

o ItIB170 is NOS permanent file name for file containg the old 
library = 

o LIBRARY180 is NOS/VE focal file name for file containing the 
old fibrary 

o €M00170 ts NOS permanent file name for file containing CI 
object text for the new module 

o NEWIIMODULE ts NOS/VE tocal file name for file containing II 
object text for the new module 

o NEWLIBRARY Is NOS/VE tocal file name for the tibrary being 
created 

o NLIB170 is NOS focal file name for new library 


NOS/VE Job Commands 


GETLFILE LIBRARY180 ILI8170 DC=B56 
CONVERTLOBJECTLFILE NEWIIMODULE CM00170 
CREATE_LOBJECT LIBRARY 

ADD MODULE LIBRARY=LIBRARY180 

REPLACE _MODULE LIBRARY=NEWIIMODULE 
GENERATE_LIBRARY LIBRARY=NEWLIBRARY 
QUIT 

REPLACELFILE NEWLIBRARY NLIB170 DC=856 
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121.4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 


Running from an interactive terminals enter: 


GETsfilename. 
ROUTEs filenamesDC=LP»sFC=RH. 


The input file which is sent to NOS/VE must be in 6/12 ASCII 
{or display code subset). The job file must be a single 
partition NOS record containing NOS/VE commands. The first 
statement must be a valid LOGIN command with users password and 
family name specified. Multi partition input files are not 
supported by NOS/VE so NOS data files used by the program must be 
obtained through the GET_LFILE command. 


1.1.5 PRINT A NOS/VE FILE 


At NOS/VE job termination the job tog will be automaticaliy 
returned to NOS. The job tog will be appended to the NOS/VE 
output file OUTPUT. NOS/VE print files must be written by BAM as 
8/8 ASCII RT=V. Print files will be converted from 8/8 ASCII 
RT=V to NOS 8/12 ASCII when they are sent to NGS and will be 
printed in upper/tower cases Ail NOS/VE output Files will appear 
in the NGS output queue (NOS H»sG disptay) with the name IRHFxxx 
as a banner. In order to print a NOS/VE files the following 
command must be issued within your job or be entered from the 
system console via the K display: 


PRINT LINKMAP 
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200 COMMAND_INTEREACE STATUS 


2el ACCESS_TO_NOSZVE_IN_DUAL STATE 


2elel LOGIN TO NOS/VE 


To initially ftogin to NOS/VE via TAFs you must cause the first 
login attempt to fail. This can be done by responding to the 
“FAMILY:" fJogin prompt with something like? "AsAsA". This must 
be done because the system will try to connect the terminal to 
IAF on the first togin attempt no matter what is typed. To 
access TAF do the fotlowing on the second "FAMILY:" prompt: 


suserspasswords TAF 


You can access TAF from IAF by doting “"HELLOsTAF”" or oby 
answering TAF to the system prompt “"APPLICATION:"™,. 


2ele2 TERMINAL USAGE 


1) The stant (/) is the prompt to enter a NOS/VE command. Any 
normal NOS/VE command can now be entered (continuation tines 
are prompted with «.e/). The full ASCII character sets lower 
or upper case and aif special characters» can be used. 


2) A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate. A new NOS/VE Interactive Job can then be started 
by responding to the "APPLICATION:* prompt with TAF. 


3) Terminal breaks (control-t and controt-p) now work. It is 
possibie to terminate a task or command and to suspend a task 
and enter anew task to process SCL commands. Controi-t 
causes a terminate break and control-p causes a pause break. 
Terminate break will terminate a command or the most recently 
executed tasks A pause break will suspend execution and 
allow commands to be entered. When a terminal is in pause 
break states two commands are availablie: 
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RESUME - resume execution at the point of interruption. 


TERMINATE ~- cause a terminate break condition as if a 
terminate break had been entered. 


Both terminate break and pause break are available to programs 
as conditions via the program management condition mechanism. 


2e1l.23 NOS/VE PROGRAM ACCESS TQ THE TERMINAL 


1) Interactive NOS/VE jobs are able to obtain terminal input 
through the AMPSGET_NEXT or AMPEGET_PARTIAL program interface 
which can be used by both task services and =user ring 
progr amse Interactive programs which use this interface 
should be able to handte both upper and lower case input in 
order to make them more convenient to use in both 64 and 96 
character set modes. 


2.2 COMMAND AND PARAMETER NAMES 


During the next few months a command supported by the system 
may not be in syne with your command interface document. The 
parameter descriptor table gives an accurates concise description 
of the command interface as currently supported. 


POL Beader's Guide 


The definition of a command's parameter tist is enclosed in 
parenthesis with a parameter description per line. Each 
description has the general form: 


PARAMETER NAME: ALLOWED PARAMETER VALUES = PARAMETER DEFAULT 
VALUE 


Parameter Names - describes the parameter name and any 
abbreviations. 


Allowed parameter vatues - describes the kind of value allowed 
and whether a tist of values is possible. The value kind can be 
further qualified. In some casess the actual values allowed are 
described using the KEY notation. The vatue kinds inctude 
INTEGER» STRING» NAMEs FILE» STATUS. 


Parameter default values - describes the defaulting rules 
and/or vatues for the parameter. S$REQUIRED and $O0PTIONAL are 
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obvious. Other values in this position will be treated as iif 
they were entered by the user on command invocation. 


See the PROC command in the Command Interface ERS for more 
details. 


The PDTs for the commands currently in the system can be 
displayed using the DISPLAY_COMMAND_INFORMATION command. This is 
documented in the nonstandard command section of this document. 


2e2el PARAMETER NAMES AND ABBREVIATIONS 


The orimary convention for a parameter name abbreviation is to 
use the first character from each word in the parameter names for 
examples fine number would abbreviate to Ine 


The status parameter is never abbreviated. Since this 
parameter is available on every commands the abbreviation 's! 
would not be avaitabte for any other parameters. 


Some abbreviations can be ‘cluster universal’® within a command 
clusters is@. within the source code utility or the permanent 
file commands. These abbreviations should be made the same even 
if an abbreviation could get by with fewer characters in some 
commands 


Where a parameter can accept a list of one or more values and 
a olurai form of the parameter name makes senses both the plural 
and singular form are allowed, 


In some situations a parameter name is used as a parameter 
name on one command and as a value on another command or function 
(DISPLAY_FILE_ATTRIBUTES command and $FILE function for 
example). The abbreviations must be the same in both places. 


It is not possibte to follow this convention in all situations 
(iee@.e. some commands contain parameter names which would result 
In duplicate abbreviations). In this case judgement and 
consideration of human factors should be applied to determine 
abbreviations. When there is already a weli known English 
abbreviations use it. 


The abbreviations for PASSWORD: PW» MINIMUM: MIN and MAXIMUM? 


MAX do not allow the singie letter convention to be followeds so 
an abbreviation was selected. 
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attach 
change 
" 


change_priority 

delete _catalog_permit 
deflete_permit 

display _catalog 
display _command_list 
display_file 
disolay_file attributes 
display _job status 
display _ilog 

display _terminallattributes 
drop job 

execute 

5 ] 


get_file 
login 
ww 


permit 
a] 


permit catalog 
ww 

” 

print 

9 

replace_file 
request_terminal 
J 


” 
bi] 
" 
set _message_mode 
set _program_options 
| 


OLD PARAMETER NAME 
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share 

new charge 
new _pfn 
name 
family 

" 


type 

info_level 

type 

attributes 

name 

from 

attributes 

name 

map 

map_options 
preset 

procedure 

max block_ltength 
max record fength 
min block length 
min record length 
user_info 
conversion 
family 

name 
application_info 
family 

share 
application_info 
family 

share 

conversion 

form 

conversion 
eoi_string 
eop_string 


no_format_effectors 


page_wait 


transparent_end count 


info_level 
map 
map_options 
preset 
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share _mode 
new_account project 
new_file_name 

job name 
familyoname 

Lid 


display_options 
wn 


job_name 
disolay options 
Li 


job_name 

foad map 
foad_map_options 
preset_value 

starting procedure 
maximum block fenagth 
maximum record fenagth 
nimimum block length 
minimum record length 
user_information 
data_conversion 
family name 

job name 
application_information 
family uname 

share mode 
application_information 
familyuoname 
share_mode 
data_conversion 

forms code 
data_conversion 
end_of_information 
end_of_partition 
formatleffectors 

hold page 
transparent_character_count 
information_fevel 
foad_map 
foad_map_options 
preset value 
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submit name job _name 
switch ” id 
terminal eocicstring end_of_ information 


be eop_string end_of partition 
” no _format_leffectors format_leffectors 
” page wait hold page 

" 


transparent_end_count transparent_character_count 


203 COMMAND _EUNCTIONS 


Eunction_ atatus 
$M0D unchanged 
S$CHAR unchanged 
$CLOCK unchanged 
SDATE unchanged 
SFILE unchanged 
S$FNAME unchanged 
S$INTEGER unchanged 
$NAME unchanged 
$ORD unchanged 
SREAL unchanged 
S$STRING unchanged 
$STRLEN unchanged 
SSTRREP unchanged 
SSUBSTR unchanged 
SUNIQUE unchanged 
$TIME unchanged 
$VAR unchanged 
$SPECIFIED unchanged 
SSET COUNT unchanged 
S$VALUE_COUNT unchanged 
SRANGE unchanged 
SPARAMETER_LIST unchanged 
$PARAMETER unchanged 
$STATUS new 
$CONDITION new 
$SEVERITY new 
$PROCESSOR new 

$J08 new 

204 SYSTEM_ACCESS COMMANDS 
Commands. status 
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*1 


205 


226 


t 


LINK_USER Updated to Rev 8 ERS 
LOGIN Updated to Rev 8 ERS —- ¥*1 
LOGOUT | unchanged 

PASSWORD new 


The famity name of the job doing the submit will be used as 
the default family name on batch jobs. The default for jobs 
submitted from NOS will be family SSYSTEM. This effectively 
means that whenever NOS/VE jobs are submitted from NOS the 
family parameter is required. 


RESOURCE MANAGEMENT 

Command status 
REQUEST_LTERMINAL | unchanged 
EILE_MANAGEMENT 

Command. atatus 
FILE unchanged - ¥*1 
COPY unchanged 
DUMP_FILE unchanged 
COMPARE unchanged 
DISPLAY_FILE_ATTRIBUTES unchanged 
SKIP unchanged 


*1 Multiple FILE commands will not be merged. 


207 


PERMANENT_EILE_ MANAGEMENT 


Command Status 

HCS GET removed 

HCS REPLACE removed 

GET_LFILE new 

REPLACE_FILE new 

DEFINE unchanged 

ATTACH WAIT parameter supported 
PURGE unchanged 

CHANGE unchanged 

PERMIT unchanged 
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DELETE_PERMIT unchanged 
DEFINE CATALOG unchanged 
PURGE _ CATALOG unchanged 
DELETE_CATALOG_PERMIT unchanged 
PERMIT CATALOG unchanged 
DISPLAY_CATALOG unchanged 
DISPLAY_FILE unchanged 
SET -WORKING_CATALOG new 

Permanent Fille Deficiencies 

1. Permanent files on NOS»s/VE are only permanent until a NOS/VE 
deadstart. 

208 SCL_-STATEMENTS_AND_ PROCEDURES 
Command. atatus 
PROC/PROCEND unchanged 
SET. COMMAND_LIST unchanged 
DISPLAY _COMMAND_LIST unchanged 
REPEAT/UNTIL unchanged 
WHILE/WHILEND unchanged 
DECLARE_VARTABLE unchanged - ¥*1 
REMOVE_VARIABLE unchanged 
BLOCK/BLOCKEND unchanged 
LOOP /LOOPEND unchanged 
FOR/FOREND unchanged 
IF/ELSEIF/ELSE/IFEND unchanged 
CYCLE unchanged 
EXIT unchanged 
WHEN/WHENEND unchanged 
CONTINUE unchanged 
CANCEL unchanged 
INCLUDE unchanged 
COLLECT_TEXT unchanged 
DISPLAY_VALUE unchanged 
EXIT PROC unchanged 
ACCEPT unchanged 
0G unchanged 
CONNECT_LFILE unchanged 
DISCONNECT_FILE unchanged 
DISPLAY CONNECTION unchanged 
change HCS variable unchanged 
disptay HCS variable unchanged 

*1 Variables can no fonger be decitared with the same names. as 
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the boolean constants. 


209 INTERACTIVE COMMANDS 


Command. status 
RESUME unchanged 
TERMINATE unchanged 
TERMINAL unchanged 
DISPLAY_TERMINAL_ATTRIBUTES unchanged 
2010 DBJECT CODE MAINTENANCE 

Comaand. status 
CREATE_OBJECT_LIBRARY new ~ *1 
DISPLAY_LIBRARY unchanged 
SELECT _DISPLAY_LEVEL unchanged 
ADD unchanged 
REPLACE unchanged 
COMBINE unchanged 
CREATE MODULE unchanged 
BIND _ MODULE unchanged 
DEFINE _ PROGRAM unchanged 
DELETE unchanged 
CHANGE unchanged 
SATISFY unchanged 
REORDER unchanged 
GENERATE unchanged 
QUIT unchanged 


*1 


¥*2 


CI to II Conversion 


command name change -~- *2 


CREATE_OBJECT_LIBRARY and the abbreviations CREOL and COL are 
available as commands rather than SCL procedures in this 
build. In addittons CREATE_QBJECT_LIBRARY supports both its 
previous names for subcommands as well as the new names 
documented in the command and parameter name changes DAP. 


The I parameter supported by the ofd COL procedure is not 
supported by the new commands. The equivalent capability can 
be realized by calfting CREATE _OBJECT_ LIBRARY and doing an 
INCLUDE on the fite that would have been quoted on the I 
parameter. 


Users of CITOLI and OBJLIST should use the new procedures 


Build Ps November 1981 


dea | 


NOS/VE Buitd P helpful hints 


12/22/81 


s 


2e0 COMMAND INTERFACE STATUS 


2210 


OBJECT CODE MAINTENANCE 
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CONVERTLOBJECT_LFILE and DISPLAY_GBJECT_TEXT. These procedures 
are described elsewhere in this document. The CITOII and 
OBJLIST procedures will be removed in the next build. 


Zell USER_SERVICES 


Command. Status 
DISPLAY_LOG | new parameters 
COMMENT unchanged 


2012 EILE_ROUTING 


Command. Status 


HCS JMROUTE unchanged 


2013 PROGRAM EXECUTION 


*1 


Command. Status 
SETLOBJECT_LIST unchanged 
SET_PROGRAM_OPTIONS unchanged 
DISPLAY_PROGRAM unchanged 
EXECUTE unchanged 
"name call" unchanged - *]1 
TASK/TASKEND new 
TERMINATE_TASK new 

WAIT new 

SET DEBUG_RING unchanged 


Warning ~- "name cali" works only for SCL procedures unless a 
FILE command has been issued to specify that the 
FILE_CONTENTS are OBJECT and the FILE_LORGANIZATION is DATA or 
LIBRARY. The FILE command must be reissued every time the 
fite is attached or brought over from NOS. 


2014 JO8 MANAGEMENT 


Command status 
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SUBMIT unchanged 
DISPLAY_JOB_STATUS . unchanged 
DROP_JGOB unchanged 
PRINT unchanged 
DROP_FILE unchanged 
DISPLAY_PRINT_ STATUS unchanged 


2e15 NOSZVE_COMMANDS_ IMPLEMENTED AS PROCS 


In this bulltds several NOS/VE commands have been implemented 
as SCL procedures in order to make the system look more fike the 
Final version. Users are urged to use these procedures rather 
than their Interim counterparts since the interim commands will 
ultimately be withdrawn. 


These procedures wilt be made available via the default system 
prolog. 


2016 NON_ STANDARD COMMANDS 


The folfowing commands provide a nonstandard means of 
performing various frequentiy performed functions. They will be 
superceded in subsequent builds by standard commands and 


capabilities. 


2el6el DISPLAY_COMMAND_LINFORMATION i DISCI 


The purpose of this command is to display current information 
about a NOS/VE command. The parameter namess abbreviations» 
allowed values and known problems for a commands as supported in 
the current systems can be determined. This is a#$nonstandard 
command and will be reptaced by the help utility sometime in the 
future. 


display _command_tnformation command name=<namedial I 
Cutitity name=create_object_libraryi 
colisource_code_utiftityiscuisystem] 
C[display_option=parameter_description_ 
pdtinotesinamesi help) 
Coutput=<file reference>] 
{statusz<status variable>d] 


command nameicn: This parameter specifies the name of the 
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command about which information is to be displayed. 


utility nameiun: This parameter specifies which utility the 
command belongs toe Omission wit! cause SYSTEM to be 
used. 


display_optionido: This parameter specifies the type of 
display being requested. The options are? 


parameter _description_tableipdt - selects a display of 
the parameter description table used by the 
command when executed, 


notes - selects a disptay of any known problems with 
the command. 


names ~- selects a display of the command names =~Ffor a 
utility. 


help - selects a disptay of the command interface 
description of the command. 


Omission wil! cause PDT to be used. 


outputio: This parameter specifies the file to which 
information will be displayed. Omission witli cause 
$OUTPUT to be used. 


status: See ERROR HANDLING. 


201602 CONVERT_LOBJECTLFILE 3 CONOF 


The purpose of this command is to get a NOS/VE object file or 
object library produced on NOS and to convert it to an object 
file suitable for processing by the NOS/VE Yoader or object code 
maintenance commands. 


convert_object_file toz<file reference> 
{from=<name>] 
Cuserz<name>d] 
Cstatus=<status variable>] 


to $ t: This parameter specifies the NOS/VE file name on 
which the converted object file is to be written. 


from $ f3 This parameter specifies the name of the NOS file 
to be converted. This is the permanent file name as 
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defined in the NOS file system and can be up to seven 
characters in lengthe 


Omission will cause the permanent file name of the TO 
parameter to be used. 


user : u: This parameter specifies the NGS user 
identification of the owner of the file. This 
parameter is only neccessary if the file is in a 
catatog other than the user who was specified by the 
most recently issued LINK_USER command. 


status? See ERROR HANDLING. 
221623 GET_QBJECTLFILE $ GETOF 


The purpose of this command is to get a previousiy converted 
NOS/VE object file from the NOS side and sets the appropriate 
file attributes that will allow the object file to be used by 
NOS/VE. 


get_object_file toz=<file referenced 
Cfrom=<name>] 
Cuser=Cname>] 
[password=<string>] 
Cstatus=<status variabte>] 


to $ t: This parameter specifies the NOS/VE file name of the 
object file. 


from { f: This parameter specifies the NOS file name of the 


object file. This is the permanent fite name as 
defined in NOS and can be up to seven characters in 
fength. 


Omission will cause the permanent file name of the TO 
parameter to be used. 


user ¢ us This parameter specifies the NOS user 
identification of the owner of the file. This 
parameter is only necessary if the file is in a catalog 
other than the user who was specified by the most 
recently issued LINK_USER command. 


status: See ERROR HANDLING. 
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201624 GETLOBJECT_LIBRARY + GETOL 


The purpose of this command is to get a previously created 
NOS/VE object tibrary from the NOS side and set the appropriate 
file attributes that will attlow the object library to be used on 
NOS/VE. 


get_object_tibrary to=<file reference> 
{from=<name>] 
Cuser=<name>] 
Cstatus=<status variable>] 


to $ t: This parameter specifies the NOS/VE file name of the 
ob ject library. 


from 3} Ff: This parameter specifies the NOS file name of the 
object file. This is the permanent file name as 
defined in NOS and can be up to seven characters in 
length. 


Omission will cause the permanent file name of the TO 
parameter to be used. 


user +; us: This parameter specifies the NOS user 
identification of the owner of the file. This 
parameter is oniy necessary if the file is in a catalog 
other than the user who was specified on the most 
recently issued LINK_USER command. 


status: See ERROR HANDLING. 
2216.5 DISPLAY_OBJECTLTEXT ¢: DISOT 


The purpose of this command is to produce a formatted display 
of the object text contained in an object file or object tibrary 
produced on NOS/VE. 


disptay_object_text file=<file> 
Coutput=<file reference>] 
Cstatus=<status variabte>] 
file { f2 This parameter specifies the object file or object 
tibrary containing the object text to be fisted, 


output 3? o: This parameter specifies the file to which the 
display is to be written. 
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Omission will cause the file SOUTPUT to be used. 


status: See ERROR HANDLING. 
2216.6 CITOII 


This command performs the same function as the 
CONVERTLOBJECT_FILE command and wilt be removed in the next 
build. Users are urged to use CONVERT_LOBJECT_FILE instead. 


The purpose of this command is to get a CI object file or 
object tlibrary from NOS and to convert it to an II object file 
suitabie for processing by the NOS/VE toader and/or object 
library generator. . 
citoii ci=<NOS file name> 

Cib=<NOS/VE Ifnd] 


Cuser=<NOS user name>] 
Cstatusz<status variablie>] 


ci: This parameter soecifies the NOS permanent file name of 
the CI object file or object tibrary to be converted. 


iis This parameter specifies the NOS/VE file name on which 
the converted (ieee. II) object file is to be written. 


Dmission will cause the CI file name to be used. 


user: This parameter specifies the NOS user name In whose 
catatog the CI object file is tocated. 


Omission will cause the user name of the user issuing 
the command to be usede 


status? See ERROR HANDLING. 
2el6.7 EDIT _FILESEDITFE 
The purpose of EDIT_FILE is to initiate the execution of the 


SCU editor on text file.~(For details see ARH3883.) 


edit -filezeditf -—- edit lines on a source file. 
(procedure file not necessarily in its final form) 
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Parameters. defaults 
file=file(source) SREQUIRED 
Cresult=file(source)] $VALUE({ FILE) 
Cinput=file reference 1] S$COMMAND_OF_CALLER 
Coutput-file reference] $OUTPUT ; 
Cstatus] 


201628 JEDIT 


The purpose of this command is to initiate execution of the 
JEDI editor built by Jack Bohnhoff. Anyone wanting information 
about the editor should contact Jack. 


jJedit from=<file>d 
Cstatus=<status variabie>d] 


from { f% This parameter specifies the file to be editteds. 
This file is rewritten after the editor terminates. 


status: See ERROR HANDLING In the NOS/VE Command Interface. 
2016.9 DEBUG 


The prototype R1 NOS/VE debugger is now availabie. Details on 
how to use the debugger can be found in the "CYBER 180 
INTERACTIVE DEBUG External Reference Specification and User's 
Guide*»s Sunnyvale DOCS number $4028. 


2016210 OBJLIST 


This command performs the same function as the 
DISPLAY_OBJECT_LTEXT command and wilt be removed in the next 
buitd. Users are urged to use DISPLAY_OBJECT_TEXT instead. 


The purpose of this command is to produce a formatted tisting 
of an object file or object library produced on NOS/VE (ieee [I 
object text). 
objlist object=<tifn> 
Ctist=<ifnd] 
Cstatus=<status variable>] 
object $! 0: This parameter specifies the object file or 
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object tibrary to be tisted. 


list $ 4: This parameter specifies the file on which the 
formatted listing is to be written. 


Omission will cause the listing to be printed on the 
focal printer. 


status: See ERROR HANDLING. 
2016211 LINKLUSER $ LIU 


The LINK_USER command is the same as documented in the NOS/VE 
command interface with the exception that the alias LIU is 
supported in the current system and the CHARGE and PROJECT 
parameters are optional (and in fact not useful in the current 
environment since we disable that feature on the NOS side). 


2el6e12 JMROUTE 


This command is an interim implementation of the final RCUTE 
command. For printing files» users should use the PRINT 
procedure now available as the JMROUTE command will be withdrawn 
In subsequent builds. 

JMROUTEs jobnames filenames PRsNVE 


jobname - name that the print file will have tin the NOQS/VE 
output queue. 


filename — name of the local NOS/VE file created by BAM that 
is to be printed. 


PR - specifies that the file is a print file (must always be 
PR). 


NVE = name of the NOS/VE family for the print file (must 
always be NVE). 


Exampie of JMROUTE command: 


JMROUTEsLISTINGsLINKMAP »s PR»NVE 
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300 PROGRAM_INTERFACE STATUS 


whether the procedure is 
modified from the previous 
in this build. Footnotes are numbered 


The "status! column indicates 
unchanged from the previous builds 
build or not avaitablie 


within each section. 


3e1 COMMAND PROCESSING 
Procedure. atatus 
CLPSSCAN_PARAM_LIST unchanged 
CLPSTEST_UPARAMETER unchanged 
CLPSGET_ KEYWORD unchanged 
CLPSGET_SET_COUNT unchanged 
CLPSGET_VALUE_COUNT unchanged 
CLPSTEST RANGE unchanged 
CLPSGET_VALUE unchanged 
CLPSDECLARE_VARIABLE unchanged 
CLPSREMOVE_VARTASLE unchanged 
CLPSREAD_ VARIABLE unchanged 
CLPSWRITE_VARIABLE unchanged 
CLPSSCAN_COMMAND_FILE unchanged 
CLPSEND_SCAN_COMMAND_FILE unchanged 
CLPSSCAN_COMMAND_LINE unchanged 
CLPSCREATE_FILE CONNECTION unchanged 
CLPSDELETE_FILE_CONNECTION unchanged 
CLPSPUSH/POP_UTILITY unchanged 
CLPSGET_COMMAND_ORIGIN unchanged 
CLPSGET_DATA LINE unchanged 
CLPSSCAN_PROC_ DECLARATION unchanged 
3e2 MESSAGE. CENERATOR 

Procedure Status 
OSPSFORMAT_MESSAGE updated - *1 
OSPSSET_STATUS_ ABNORMAL unchanged 
OSPSAPPEND_STATUS_ PARAMETER unchanged 
OSPSAPPEND_STATUS_INTEGER unchanged 
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302 MESSAGE | GENERATOR 
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*1 


Formatted messages are now produced and a 


fevel™ option is supported. 
~RESQURCE MANAGEMENT 


Praecedure_ 


RMPSREQUEST_UMASS_STORAGE 
RMPSREQUEST TERMINAL 


All terminal attributes 
RMPSREQUEST_TERMINAL call 
operational: 


auto_input 
transparent mode 
prompt _file 
prompt ustring 


oo9o80 


Files assigned 
following BAM requests: 


AMPSOPEN 
AMPSGET_NEXT 
AMPSGET_DIRECT 
AMPSGET_LPARTIAL 
AMPSPUT NEXT 
AMPSPUT_DIRECT 
AMPSPUT_LPARTIAL 
AMPS$CLOSE 


90o0o00c0:CUOoWlU8lUO8lUO 


-PROGRAM_EXECUTION 


Procedure. 


PMPSEXIT 
PMPSEXECUTE 


PMPSTERMINATE 

PMPSAWAIT_TASK_ TERMINATION 
PMPSMODULE_TABLE_ADDRESS 
PMPSENTRY_POINT_TABLE_ADDRESS 
PMPSPUSH TASK DEBUG_MODE 
PMPSSET_LTASK_DEBUG_MODE 
PMPSTASK DEBUG MODE _ON 


to a terminal 


can 
but 
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“current message 
Status 
unchanged 
unchanged 
be specified on the 


onty the fotlowing are 


device can be accessed via the 


Status 


unchanged 
changed program 
description 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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305 


PROGRAM EXECUTION 


PMPSSET_DEBUG_RING 
PMPSDEBUG_RING 

PMPSCHANGE _DEBUG_LIBRARY LIST 
PMPSPOP_TASK_ DEBUG MODE 


-PBOGRAM. COMMUNICATION 


Procedure. 


OSPSAWAIT_LACTIVITY COMPLETION 
PMPSDEFINE_QUEUE 
PMPSREMOVE_QUEUE 
PMPSCONNECT_QUEUVE 
PMPSDISCONNECT QUEUE 
PMPSSEND_TO_QUEUE 
PMPSRECEIVE_FROM_QUEUE 
PMPSSTATUS_QUEUE 
PMPSSTATUS_ QUEUES DEFINED 
PMPSGET_QUEUE_LIMITS 


~CONDITION PROCESSING 


Procedure 


PMPSESTABLISH_CONDITION HANDLER 
PMPSDISESTABLISH_COND_HANDLER 
PMPSCAUSE_CONDITION 
PMPSCONTINUE_TO_LCAUSE 

PMPSTEST CONDITION HANDLER 
PMPSVALIDATE_PREVIOQUS_SAVE_AREA 
PMPSESTABLISH DEBUG_CFF 
OSPSSET_USTATUS_FROM_CONDITION 


~PROGRAM_SERVICES 


Procedure. 


PMPSGENERATE_UNIQUE_NAME 
PMPSGET_TIME 
PMPSGET_MICROSECOND_CLOCK 
PMPSGET_LTASK_CP_TIME 
PMPSGET_DATE 
PMPSGET_LUSER_LIDENTIFICATON 


unchanged 
unchanged 
unchanged 
unchanged 


Status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


atatus 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


afatus 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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PMPSGET_ACCOUNT_PROJECT unchanged 
PMPSGET_JOB_LNAMES unchanged 
PMPSGET_JOB_ID unchanged 
PMPSGET_JOB_MODE unchanged 
PMPSGET_PROGRAM unchanged 
PMPSGET_TASK_ID unchanged 
PMPSMANAGE_SENSE_ SWITCHES unchanged 
PMPS$GET_OS_VERSION unchanged 
PMPSGET UPROCESSOR_ATTRIBUTES unchanged 
RPMPSDEFINE_DEBUG_ENTRY unchanged 
PMP$GET_DEBUG_ENTRY unchanged 
PMPSMODIFY_DEBUG_ENTRY unchanged 
PMPSREMOVE_DEBUG_ENTRY unchanged 
328 LOGGING 
Proceduce_ Status 
PMPSLOG unchanged 
PMPSLOG_ASCII unchanged 
3.9 _EILE MANAGEMENT 

Procedure. status 
Sequential Access unchanged 
Byte_Addressabie Access unchanged 
Record Access unchanged 
Segment Access unchanged - *1 
ViSystem Svecified unchanged 
ViUser Specified unchanged 
U_System Specified unchanged 
U_User Specified unchanged 
F System Specified unchanged 
F_User Specified unchanged 
AMPSDESCRIBE_NEW_FILE unchanged 
AMPSFILE unchanged 
AMPSGET_LFILE_ATTRIBUTES unchanged - *4 
AMPSFETCH unchanged 
AMPSSTORE unchanged 
AMPSCOPY_FILE unchanged 
AMPSRENAME unchanged 
AMPSRETURN_LOCAL_FILE unchanged 
AMPSOPEN unchanged 
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AMPSCLOSE unchanged 
AMPSFETCH_ACCESS_INFORMATION unchanged 
AMPSSKIP unchanged 
AMPSREWIND *2 
AMPSWRITE_END_ PARTITION unchanged 
AMPSGET_NEXT unchanged 
AMPSGET_DIRECT | unchanged 
AMPSGET_PARTIAL unchanged 
AMPSPUT_NEXT unchanged 
AMPSPUT_DIRECT unchanged 
AMPSPUT_PARTIAL unchanged - *3 
AMPSSEEK_DIRECT unchanged 
AMPSGET_ SEGMENT POINTER unchanged 
AMPSSET_LSEGMENT_EOI unchanged 
AMPSSET_ SEGMENT POSITION unchanged 
AMPSSETULOCAL_NAME_ABNORMAL unchanged 
AMPSSET_LFILE_INSTANCE_ABNORMAL unchanged 
AMPSACCESS_ METHOD unchanged 
AMPSFETCH _FAP_POINTER unchanged 
AMPSSTORE_FAP_LPOINTER unchanged 


*1 Segment access 
If a segment access file is written and an 
AMPSSET_LSEGMENT_LEODI is not issued to record the EQI» EQI 
remains zeroe The highest page referenced is not yet used as 
the default EDI. This particularly affects those who wish to 
make heaps permanent because EQI is always zero for a heap. 


¥2 AMPSREWIND 
The WAIT parameter on the procedure call is not supported. 


*3 AMPSPUT_ PARTIAL 
PUT PARTIAL with the TERM_OPTION = AMCSTERMINATE does not act 
as a put next if a preceding START was not issued. 


*4 AMPSGET_LFILE_ATTRIBUTES 
The EXISTING FILE parameter is not impfemented correctty. We 
have a PSR indicating that the value of existing_File is 
always set to FALSE. Howevers the code appears to always set 


the value to TRUE. In any cases the vaiue cannot be relied 
upone 


3010 _PERMANENT_EILE_ MANAGEMENT 


Procedure. afatus 
PFPSDEFINE unchanged 
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PFPSATTACH 

PFPSPURGE 

PFPSCHANGE 

PFPSPERMIT 
PFPSDELETE_PERMIT 
PFPSDEFINE_CATALOG 
PFPSPURGE_CATALOG 
PFPSPERMIT_CATALOG 
PFPSDELETE_CATALOG_PERMIT 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


Permanent file program interface deficiencies 


1. 


321 


Permanent files on the NOS/VE are 


NOS/VE deadstart. 


1 MEMORY MANAGEMENT 


MMPSADVISE_IN 

MMPSADVISE_OUT 
MMPSADVISE_OUT_IN 
MMPSWRITE_MODIFIED_PAGES 
MMPSCREATE_SEGMENT 
MMPSDELETE_SEGMENT 
MMPS$STORE_LSEGMENT_LATTRIBUTES 
MMPSFETCH_SEGMENT_LATTRIBUTES 
MMPSVERIFY_ACCESS 

MMPSFREE 

MMPSLOCK PAGES 
MMPSUNLOCK_PAGES 

MMPSFETCH PVA_LUNWRITTEN_PAGES 


3eol2 STATISTICS _EACILITY 


SFPSESTABLISH_STATISTIC 
SFPSENABLE_STATISTIC 
SFPSDISABLE_STATISTIC 
SFPSDISESTABLISH_USTATISTIC 
SFPSEMIT_STATISTIC 
SFPSEMITLSYSTEM_STATISTIC 


only 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


unchanged 


unchanged 
number of 


permanent 


until a 


locked pages per 


segment restricted to 32 


unchanged 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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3013 INTERACTIVE FACILITY 


LTFPSTERMINAL unchanged 
IFPSFETCH_TERMINAL unchanged 
IFPSSTORE_TERMINAL unchanged 
IFPSGET_DEFLT_TERMINAL_ATTRIBUTES unchanged 
TFPSGET_LTERMINAL_ATTRIBUTES unchanged 


3.14 NOSZVE_EXCEPTIONS 


The following summarizes the exception code ranges currentty 
assigned to NOS/VE. These code ranges represent a finer 
breakdown than the one specified in the SIS for internal NOS/VE 
development purposes. Howevers it is important to remember that 
onty the product identifiers documented in the SIS may appear in 
error messagese 


Common Modules 92000 — 93999 
Common Code Generator Bs000 - 829999 
Product 
Exception Code Identifier Product Name 
1 - 1585999 Reserved 
1593000 - 159,999 SY System Core 
1603000 — 1699999 AM Basic Access Methods 
1602000 = 1633999 BA Basic Access 
1643000 - 1645999 LN Local Name Mor 
1653000 — 1653999 JF Job File Mor 
1663000 - 16639999 SR Conversion Services 
1673000 =- 167999 CM Configuration Mgmt 
17029000 - 1793999 CL Command Lanquage 
1803000 ~— 1893999 JM Job Management 
19039000 — 1993999 LL Loader 
2009000 — 2099999 MM Memory Management 
2003000 — 2049999 MM Monitor Level 
2059000 - 2052999 MM Task Level 
21039000 — 2199999 os Operating System 
2109000 = 2103999 os oS 
2113000 =- 2115999 MT EXEC 
2129000 = 2123999 I0 MS 170 
2133000 - 21339999 Io Tape 1/0 
21439000 — 2143999 DM Device Management 
2152000 —- 2153999 ML Memory Link 
2169000 —- 2163999 IF Interactive 
2172000 —- 2179999 TM ™ Monitor 
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2183000 —- 2183999 T™ ™ Task 

2199000 = 2199999 JS Job Swappers 
2203000 ~ 2293999 PF Permanent File Management 

2212000 — 22139999 ST Set Management 

2229000 - 2229999 PU Permanent File Utilities 
23039000 =— 2399999 PM Program Management 
2402000 —- 2493999 RM Resource Management 
25039000 =— 2599999 OF Operator Facility 
2602000 = 26929999 AV User Administrator 
2702000 = 2799999 Ic Interstate Communication 
2802000 —- 2899999 RH Remote Host Facility 
2902000 — 2993999 OC Object Code Utilities 
3003000 — 3093999 DB Deadstart/Recovery 
310,000 ~— 3193999 MS Maintenance Services 
3209000 =— 3293999 Reserved 
34039000 — 3499999 SF Statistics Fac. 
3303000 = 3399999 US User Errors 
5009000 — 509,999 - AA Advanced Access Method 
5103000 =—- 5199999 AG ALGOL 
5209000 — 5299999 AL Assembly Language 
5302000 — 5393999 AP APL 
5409000 —- 54959999 BA BASIC 
5502000 —- 5599999 CA Conversion Aids System 
5609000 —- 56939999 cB COBOL 
5702000 — 5793999 CY CYBIL 
5802000 — 5895999 FT FORTRAN 
5902000 - 5993999 PA PASCAL (Wirth) 
6002000 — 6093999 Pi PL/1 
6102000 —- 6193999 SM Sort Merge 
6202000 = 6299999 sc Source Code Utility 
6402000 = 6499999 DB Debug 
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4.0 DUAL STATE DEADSTART AND OPERATION 


400 DUAL STATE _DEADSTART_AND_ OPERATION 


4e1 CURRENT _DUAL_STATE_ CONFIGURATION 


The Arden Hills S2 development systems are configured to run 


with three FMD units. 
o FMD Unit 43 
This unit contains the following: 


- AL70 NOS (5.3 as released)» CTI» 
deadstart files 


CMSE» EI binariess NOS 


- Filles associated with user name LIBRARY 
- Files associated with user name SES 
- Files associated with DEVl»s DEV2s REL1»s INT. 


o FMD Unit 41 


This is a scratch unit. This unit 
there is a system error during 
following tines to the CMR deck: 
INITIALIZEs1sAL. 
GDe 


o FMD Unit 42 


This unit contains the folloning: 


can be initiatizeds if 
deadstarts» by adding the 


- NOS/VE Devetopment Area PL*s and Member PL*s 
- NOS/VE Deadstart Files to be tested (saved in individual 


user's catalogs) 


- Files associated with user name INT2 


402 USER NAMES _AND_PERMANENT_EILES 


1) The convention used for creating user names on NOS/VE is as 


follows: 


o Your user name will be your Initiats. 
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4.2 USER NAMES AND PERMANENT FILES 


WO 0 TE PD OO PD D8 90 TE 90 FO 88 FO PE 08 98 08 FE BE O80 98 8 OE PE OE FE 00 O80 TE PO OE TE AD OE BE PE OE OO POPE PE NO PO Pb TE OE PO 8 PE OO 20 OF 08 0 70 PO 08 28 Pe ne ee re ee nem 


o Your password will be these 3 Setters followed 
letter ‘x!, 

o You must see COMSOURCE (ReKe Cooper - *x3092) 
assigned a user Index 


2) PF dumping and toading 


the 


be 


You may use "™SES.DUMPPF™ on $N/101 to dump your permanent 


fies to tapes and then toad them onto your user name on 


A170 


NOS using “SES.LOADPF®, Documentation on how to use these 


SES procedures and what their parameters are is included 
the SES User's Guides or they can be obtained by typing: 


SESsHELP.DUMPPF and SESsHELP.»LOADPF. 


3 TO_RELOAD_CONTROLWARE_EOR_ THE NOSZVE_DISK_ DRIVER 


The following commands need to be entered from deadstart 


Set deadstart panel to deadstart from unit 43 

Push D/S button 

Select "M" display 

Type in "6.26" 

Carriage return 

Type in "CW MAS 2" carriage return wait until LOADED 
Then redeadstart as described in the next section 


990000086 


40% §170_NOS_DEADSTARI 


in 


o Set the D/S panet to deadstart from the primary system disk. 


This is Unit 43 for allt Build P systems. 


Push D/S button 
Select "0" display 
Select "H" display 
Enter CM=10000 
Enter (CR) 

Enter date/time 


oeo0o00 0 


Wait for deadstart to complete. 


Note: The deadstart tape DUAL6OP (which is currentiy installed 


on 


unit 43) is found in the area in the northeast corner of the room 


where the tape cabinet is found. 
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405 NOSZVE_DEADSTART_AND_INSTALLATION 


o The following File must be availabite in your catalog on the 
52: 


TPXXXK contains a NOS/VE deadstart imagee This must be a copy 
of the dual state deadstart images available from the link 
procedures. 


o Bring up dual state: 
XeUPMYVE (CAT=mycats DEViz=scat) 
where mycat = user catalog (as before) 
scat = system catalog - INT2» INTls DEV1 or DEV2 


NOS/VE is currently generated and initialized on both NOS and 
NOS/VE. All source and object tibraries that make up the NOS/VE 
System are produced on NOS and therefore must be converted from 
their CI to II counterparts. Other parts of installing and 
initializing the system {eege building the $SYSTEM catalogue) 
are performed by command tanguage procedures on NOS/VE. Since 
the same system will be deadstarted many times In a closed shop 
environments it is advantageous to only perform the conversion 
from CI to II a single time; save the results in the NOS file 
system and then simply bring the files back during deadstart. 


The actual files that get installed and toaded on each 
deadstart are determined by a command language procedure (the 
system profile) interpreted on NOS/VE. This procedure can be 
modified by each site to Initialize their NOS/VE environment in 
the most suitable fashion. The process of building the system 
profite and of performing the CI to [I conversions is referred to 
as an installation deadstart and the process of executing the 
system profite and of fetching previously converted files from 
NOS and making them avaliabfle in the NOS/VE file system is 
referred to as a deadstart. <A single command is avaitabie to 
perform both an installation deadstart and a deadstart. 


4e5e1 DS 

The purpose of this command is to perform an instattiation 
deadstart or a deadstart of NOS/VE. 
ds Cinstatt=<boolean>] 

{get_source_libraries=<boolean>] 

Cget_products=<boolean] 


Cechoz<boolean>] 
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Calternate_user=<NOS_user_name>] 
Csave_instali_files=<boolean>] 
Cvatidate_users=<boolean>] 
Cdebug=<boolean>]. 

Chetp=<file reference>d] 
(status=<status variabie>]) 


install H i: This parameter specifies whether an 
instaliation deadstart is to. be performed, Valid 
specifications are: 

TRUE - Installation deadstart to be performed. The 
system tibraries (CYBILIBs SYSLIBs etc.) are 
bullt from CI object files. 

FALSE - deadstart to be performed. The system 
fibraries are obtained from the results of a 
previous installation deadstart. 


Omission will cause a deadstart to be performed. 


get_source_jibraries i gsi: This parameter specifies whether 
SCU libraries are to be installed. Valid 
specifications are: 
TRUE - fibraries are installed 
FALSE ~- ftibraries are not instatied 


Qn the Arden Hilts closed shop S$2 systems the SCU 
libraries to be installed are: 
OSLPI - operating system program interface 
Subset of NOSVEPL - operating system source 
library 


Omission witli cause SCU libraries to be ItInstatied. 
get_products i gp: This parameter specifies whether the 

object tibraries defining the current product set are 
to be instalied. Valid specifications are: 
TRUE - the products are instalted 
FALSE - the products are not installed 
On the Arden Hills closed shop S2 systems the product 
set to be installed consists of: 

CYBIL 

BANNER 
Omission will cause the product set to be installed. 


echo { e: This parameter specifies whether the commands 
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should be echoed to the console during execution. 
Valid specifications are: 

TRUE = echo commands 

FALSE - do not echo commands 


Qmission will cause commands not to be echoed. 


alternate_user  { au: This parameter specifies what NOS user 
to check if the default NVE user does not have the 
needed file. Any NOS user name is allowed. 


Omission will cause INT1 to be used.» 


save_install_files i sif: This parameter specifies whether 
to save the system tibraries created by an installation 
deadstart. This parameter is ignored for a normal 
deadstart. Valid specifications are: 
TRUE - save the instatted system libraries 
FALSE = do not save the [Installed system !fibraries 


Omission wilt!l cause the files not to be saved. 


validate_users {! vu: This parameter specifies whether to run 
the job that validates NOS/VE userse Valid 
specifications are: 
TRUE = run the validation job 
FALSE - do not run the validation job 


Omission witt cause the vattidation job to be run. 


debug $ d: This parameter specifies whether the procedure 
should abort if an error condition is detected. Valid 
specifications are: 
TRUE =- do not abort on an error 
FALSE - abort on an error 


OQmisston wittl cause the procedure to abort when an 
error is encountered. 


help ¢ h: This parameter specifies whether help information 

is to be written. If this parameter is specified» the 
help information will be written to the specified file 
and the procedure will terminate. 


Omission witl cause the procedure to execute and the 
help information not to be written. 


status: See ERROR HANDLING In the NOS/VE ERS. 
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If you change any of the following decks you MUST use the 
installation deadstart from your own catalog (with files CYBILGO>, 
XLJCOL» XLJOSL»s and XLJLIB)» or you must use the alternate_user 
parameter to specify a NOS catalog containing the files (e.g. 


DEV1). 

AMMTSA BAMDVR BAMPC4 BAMPC2 BAMPC1 BAMPC3 TIMRSE TIMRLE 
ITFMEXEC TIMA72H ITIMTOEL IIMRUSM ITIMDC2S OCMREDO GCMMUR OCMBIM 
OCMSDL OCMEND OCMLP OCMCPY OCMCRM OCMGEN OCMMOMS OCMDEF 
OCMOLG OCMCDL OCMOBJ OCMCHA OCHOFH OCMADD OCMNP NCMDEL 
OCMCOM OQOCMSAT RHMQAF RHMQTP RHMSFM RHML OF RHMMLI 
RHMQTE RHMLCF RHMLOG RHMQRE RHMA12 RHM12A 
RHMWLF RHMRTN RHMGDM USORT UUSER1 UUTL 


4e5e2 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 


Type 

Ken» where n is the UPMYVE control point number. 
KeLIU (your unsNVE) your _password. 

KeGETF DS. . 

KeDS TRUE FALSE FALSE AL=scat. 


The system {is up when the following message comes up: 
w~~-- PDeadstart Completed --- 
~-- Ready for commands ---< 


4e5e3 EXAMPLE OF NOS/VE DEADSTART 


The Integration system has had the installation deadstart run on 
it. <Also the files produced by the Instattation deadstart have 
been made semi-private and are found on the catalog used in the 
UPMYVE call. 


Type (where DEV1 is the same as the CAT=value in the UPMYVE 
call): 

Kane where n is the UPMYVE contro! point number. 

KelLIU (DEVI»sNVE) DEVIX. 

KeGETF DS. 

KeDSe 


The system is up when the following message comes up: 


-~- Deadstart Completed <--- 
“-—-=- Ready for commands =< 
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%e5e4 EXAMPLE OF MINIMAL NOS/VE DEADSTART 


The minimat deadstart shown below may be useful to OS 
developers who need to get the system up quickiy and do not need 
the product set or validated users. Note that if a job (batch or 
interactive) is to be run it will have to be run under user JAN. 
Type _ 

Keene where n is the UPMYVE controf point number. 
KeLIU (your unsNVE) your_password. 

KeGETF DS U=scat.. 

KeDSs»NO NO VU=NO AU=scat. 


This deadstart takes a little tess than two minutes. 
The system is up when the following message comes ups 


~-=- Deadstart Completed --- 
~-- Ready for commands ——= 


406 NOSAVE_INTERACTIVE FACILITY OPERATION 


406.1 DPERATOR INITIATION 


To bring up the NOS/VE interactive facility do the following: 
1) Bring wp NOS/VE. 
2) Bring up NAM 


At the system.consotfe enter: 
3eNAMS2.- 


3) If IAF is not up at contro! point ls enter: 
IAF. 


4) Bring up A170 part of interactive: 
- TAFNVE. 
Control point three must be free or rolloutable tieee NAM should 


not be there). This also brings up PASSON and the MLI subsystem 
control! points. 
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406.2 OPERATOR TERMINATION 


To terminate NOS/VE tnteractive any of the following may be 


done: 


3e-CFO.DIsAP=TAF. (3 is the NAM contro! point number) 


This is the preferred method. To bring NOS/VE interactive 
back ups you must first do a 3eCFOeENsAP=TAF. 


3e-CFO.DIeNE. (3 is the NAM control point number) 


This terminates the entire network including IAFsRBFs etc. 


4e62e3 OTHER OPERATOR CAPABILITIES 


To logically turn the printer ons under DSD enter: 
ON32. 
FORM329TM. 


To send a “shutdown warning™ to all terminalis togged on to TAF 
doz 

3e-CFO.~IDsAP=TAF. (3 is the NAM contro! point number) 
To send a message to all terminats do: 

3-CFOeMSGsALL»mesagee (3 is the NAM control point number) 
PASSON has the ability to record various types of diagnostic 
information. This capability is controlled via the sense 
switches at the PASSON control point. To turn a sense switch 
on (off) at controt point N do: 

NeONSWXe (NeOFFSWXe) 
Where xX Is the desired sense switch (1 to 6). The PASSON 
defauit is ail sense switches off. It will take aéo$short 
period of time before PASSON detects a change in a sense 


switch and reacts to it. The sense switches currently used by 
PASSON are: 


switch #_ use 


1 Network Trace 
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2 PASSGN Logic Trace To Dayfile 


3 Memory Link Trace To Dayfitle 


4e7 BOUTE_AN_ INPUT _EILE_FROM_C1z70_10.€180 


Through the system consoles enter? 
Type 

XeDIS. 

USERsAsBe 

GETsfitenamee 


where fifename identifies the input file to be routed. 
ROUTEsfilenamesDC=LP»FC=RH. 


408 K_DISPLAY ASCIT 


Support of 6-12 ASCII from the console (K disptay) causes the 
following changes: 


INPUT TRANSLATED_TO_ INPUT IBANSLATED_1O 


41 = 4 ¢ { 

2 " /) ] 

13 # /+ > 

44 $. /- < 

75 {reversed /) /x e 

16 ; /* * {single quote) 
47 ? 4/ / 

78 { /» 3 

49 } 4A to /Z a- 2z (lower case) 
70 (underscore) 


(The major incompatibiltities with earlier systems are “for 
characters for 3; and *. To get a semicolons type /6s to get 
a ' (single quote)s type /* 


409 DSOI_INEQRMATION 


To create an Express Deadstart Dump (EDD) tape: 
1) Mount scratch tape (ring in) on a 9=—track drive. 
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4.0 DUAL STATE DEADSTART AND OPERATION 
429 DSDI INFORMATION 


2) 
3) 
4) 
5) 


6) 


7) 
8) 


9) 


Push D/S button. 

Select U (utilities) display. 
Select — (EDD) display. 

Set channel ($2213). 

Set ECUU (S$2=0luu) 

E = equipment 


C = 1 for 67X drives 
2 for 66X drives 


uu = unit number of the tape drive to be used. 
Answer "non zero inhibits rewind" with a CRs 


Answer "dump number" with a CR. 


Answer “dump controtware™ with a CR. 


* =- Warning if this step is omitteds OSDI canot process 
the dump tape. 


To create a listing of the EDD tape: 


1) 
2) 


3) 


REQUEST» DUMPa NTs D=PEsF=S aL B=KUsPO=RsVSN=your choice. 


GET»sDSDI/UN=DEV1. (On S/N 101.) 
or 
GET»sDSDI/UN=DEV1. (On S2-) 
Create DSDI directives file: 
A DSDI directive file should include the following: 


IOUMR. 

PROMR. 

MEMMR. 

PRORF. 

Weafirst_byte_addressslast _byte_adress»sasid. {where the 
first _byte_address and tJlast byte _address are hex byte 
addresses and asid is the asid of the segment to be 
dumped) 
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4) Execute DSDI: 


RFL»s60000. 
DSDIsMsDsTI="input directives file™. 


5) To run Cafter the first time): 
DSDIsI=n. 
(Does not read tape again.) 
6) To run interactively: 
Same as aboves except to do W command must first do: 
BUTPUTsLISTFIL. 


7) #©€170 OSDI jinformation can be found in Chapter 10 of the 
NOS SYSTEM MAINTENANCE Manual. 


A170 DSOI info can be found in document ARH3060 -- GID 
for A170 NOS/S2. 


4010 NOSZVE_ TERMINATION 


o Bringing down dual state: 
Ke *BYEVE. 

o If not a normal termination 
Ke ¥RUN» 


Ke*ENDLST. 
Ke*ENDRUN. 


e011 A1ZQ_NOS_SHUTDOUN 


Before teaving the machines it is necessary to bring NOS 
downe If NOS has crasheds a tevel 3 deadstart must be attempted 
even if the only reason is to bring NOS downe To bring NOS downs 
do the foltowing: 

1) #4xEnter: 
CHE 
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The screen will display: 
CHECKPOINT SYSTEM. 
Enter: carriage return 


2). Make sure no mass storage device has a checkpoint raquested. 
To do thiss enter: EsM. If the display shows there are no 
"C"%s in the status fields then all devices are checkpointed 
and you may continue. 


3) Enter: 
STEP. 


4) Push deadstart button. 
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5e0 SYSTEM_CORE DEBUGGER 


The System Core debugger provides a set of capabilities 
intended to assist in debugging the operating system. Services 
provided by the debugger are task oriented: selection of the 
tasks to be debugged must be made via debugger subcommands. No 
tasks will be under control of the debugger untess they are 
selected. The selection capability allows any number of tasks to 
be debugged simultaneousiy; from one task to all tasks in the 
system. Obviously a capability this powerful must be used with 
some cares The System Core debugger uses the debug hardware to 
provide these capabilities. 


Jel SYSDEBUG 


The purpose of this command is to Initiate execution of the 
system core debugger. This command can be issued from the 
deadstart command file or as a command in any job. 


sysdebug 


This command has no parameters; all information the debugger 
requires is provided via subcommands. 


5e2 SUBCOMMAND PARAMETER DEFINITIONS 


€name> %~2?2 1-8 character breakpoint name 

Ccondition> 3232 READS WRITES RNIS BRANCHISCALLIDIVFLT? ARLOSi 
AROVFELIEXOVELSEXUNFLSFPLOSTFPINDEFS INVBDP 

Cbase> %:= process virtual address 

<offset> s:= integer 

<length> 3:3:= Integer 

<frame> 232 1.2100 

Ccount> 2232 144210600 

Cregid> 232 XFASP 

<regno> 332 0221550.20F (16) 

Chex vstring> 23:2 thex string! 

<timed 232 1..(2**31)-1 

<ystring> <s3:2 'charstring! 

<datatype> 222 HEX ASCIIZASCIDEC 
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€sefector> 22= FULLIAUTOSSAVE 


503 SYSTEM_CORE DEBUGGER SUBCOMMANDS 


a 


Within the descriptions which follows optional parameters are 
enctosed in brackets. Default vatues for optional parameters are 
aiso defined. 


Se3el SELECT 


The purpose of this subcommand is to select the tasks in which 
the system core debugger is to be activee When the debugger is 
First calleds it is not active in any taske To use the debugger 
therefores it is necessary to select the tasks In which it is to 
beactive. 


select <selection option> [<ring number> $$ <active job tist 
ordinal>] 


selection_option: This parameter specifies one of a series 
of selection options used to contro! the tasks in which 
the debugger will be active and some other debug 
options. The selections are remain in effect until 
they are explicitly changed with subsequent SELECT 
subcommands.e Vatid selection options are: 


Crightileft> - This setects the screen for the debug 
display. The display stays active when the screen is 
switched. 


<jobmonitorinojobmonitor> - This selects whether or not 
to debug job monitor tasks. 


cusersnouser> - This selects whether or not to debug 
user tasks (i.e. those that are not job 
monitors). 


<highring> - This specifies the highest ring in which 
debug traps will be recognized. Traps occurring 
in rings above this selection will be ignored. 


<jobinojob> - This enables or disables debugging for 
the job at the specified active job tist ordinal. 
The system job has an active job list ordinal of 
Zeros 


Build Ps November 1981 


5-3 
NOS/VE Build P helpful hints 
CR Ke Me Reh Ren tadhe Ao dn ttt Rend De, Rerdie dadi Aide Ka Kn Radin Riadhtedetedn Renda Ae Aendicard ind ndndeedndin de dndadedeead wubeewasesseelee. 81 
520 SYSTEM CORE DEBUGGER 
5e3e1 SELECT 


Calijebsinojobs> - This activates or deactivates 
debugging in all jobs. 


The initial selections are: RIGHT» NOSTEP>s 
NOJOBMONITORs NOUSER»s HIGHRING=0» NOJOBS. 


5e3e2 BREAKPOINT ¢: 8B 


The purpose of this subcommand is to selects a program 
Interrupt which is to occur upon occurrence of a specified 
condition within a specified virtual address range. 


breakpoint <name> <condition> (<base>] C€<offset>] ([<length>d] 


The <name> is any user supplied name for identifying the 
breakpoint. A maximum of thirty two breakpoints can be 
selected. When a trap occurss the <name> of the breakpoint which 
caused the trap is displayed. 


The base parameter is required when specifying a new 
breakpoint name; offset and tength specifications are optional in 
this case. When adding a new condition selection to an existing 
breakpoints bases offsets», and tength parameters may not be 
specified. 


Bases offsets and tength parameters define the desired virtual 
address ranges <base> + <offset> yields ai first-byte-address; 
first-byte-address + <length> -1 yields a ftast byte address. 
Default parameter values: 

<offset>: Oo 
<length>: 1 
50303 REMOVE BREAKPOINT $ RB 


The purpose of this subcommand is to deselect a previously 
selected program interrupt. 


remove_breakpoint <name>d (€<condition] 

If onty the name parameter is specifieds all conditions 
associated with the breakpoint are deselected and all evidence of 
the breakpoint is removed. If the condition parameter is 
specifieds only that condition is deselected; howevers if the 
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specified condition is the only condition selecteds all evidence 
of the named breakpoint is removed. 


50304 LIST_BREAKPOINT ! LB 


The purpose of this subcommand is to provide a list of 
currentiy selected breakpoints and associated conditions. 


list breakpoint [<name>] 


If the name parameter is specifieds information is displayed 
for the named breakpoint onty. If the name parameter is not 
specifieds information is displayed for ail currently defined 
breakpoints. 


50325 CHANGE _BREAKPDINT $ CB 


The purpose of this subcommand is to change the virtual 
address range of a previously specified breakpoint. 


change_breakpoint <name> <base> [<offset>] ([<length>] 


Bases offsets and fength parameters define the desired virtual 
address range: <base> + <offset> yieids a first—byte-address; 
first-byte-address + <length> -1 yietds a tast byte address, 


Default parameter values: 


<offset>: 0 
€<tengthd>: 1 


50326 TRACE_BACK 3 TB 


The purpose of this subcommand is to provide information 
relevant to stack Frames associated with an interrupted procedure 
and its predecessor procedures. This subcommand does not 
currently validate the PVAs in the stack it is tracings therefore 
access viotations may occur if the stack being traced has been 
destroyed. 


Information disptayed for each setected stack frame consists 
of: 
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Stack frame number 3 

Current P<address of the associated procedure}; 
Virtual address of the start of the stack frame; 
Virtual address of the stack frame save area. 


poe 


trace _back [<frame>] ([<count>] CFULLi SHORT) 


The frame parameter specifies the number of the first stack 
frame for which information is to he displayed. Stack frame 
number one fs associated with the interrupted procedures stack 
frame two is associated with the interrupted procedure's 
predecessors etce 


The module name provided on the traceback is usually correct 
but not guaranteed. 


The count parameter specifies the total number of stack frames 
for which information is to be displayed. 


Default parameter values: 
<frame>: 1 
<count>: 1 

50307 DISPLAY _STACK_FRAME { DSF 

The purpose of this subcommand is to display selected 
information from a specified stack frame. 
display stack frame ([<frame>] [([<selector>] 

The frame parameter specifies the number of the stack frame 
for which information is to be disptayed. {Stack frame number 
one is associated with the interrupted procedures stack frame two 
is associated with the interrupted procedure's predecessors 


etc.) 


The selector parameter identifies a region of the specified 
stack frame: 


AUTO: Causes the automatic region of the stack frame to be 
displayed. 


SAVE3 Causes the save area of the stack frame to be 
displayed. 


FULL? . Causes both the automatic and save areas of the stack 
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frame to be displayed. 

Default parameter values:. 

<frame>d: 1 

€selector>: FULL 
52328 DISPLAY_REGISTER : DOR 

The purpose of this subcommand is to display the contents of a 

specified register of an interrupted procedure. 
display_register <regid> ([<regno>] (<datatype>] 
Default parameter values: 

<regno>: 0 

<datatype>: HEX 


50309 DISPLAY_MEMORY ¢ DM 


The purpose of this subcommand is to display the contents of a 
specified area of virtual memory. This subcommand does not 
currently validate the PVA it is displayings therefore ahrdware 
access violations will occur when attempting to dispiay non 
readable memory. 


display_memory <base> C<tength>d]) 
Default parameter values: 


<fengtho: 8 
523210 CHANGE _ MEMORY $ CM 


The purpose of this subcommand is to set a specified value 
into a specified ftocation of virtual memory. This subcommand 
does not currentiy validate the PVA it is changings therefore 
hardware access violations will occur when attempting to change 
nonwritable memory. 


change_memory <base> <hex _vstring> 
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5e3e1l RUN 


The purpose of this subcommand is to invoke program execution 
after a selected program interrupt has occurred. 


run 
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660 JTAND_ALONE_DEADSTART 


A standatone deadstart tape is a9 tracks unitabeled I formats 
1600 BPL density tape ( produced by the NVESYS procedure). To 
deadstart in standalone modes perform the following steps: 


1)9Set the deadstart panet for standard disc deadstart: 
Ch=1 U=43 


2)Push deadstart button; select M display. 


3Enter: XYZ{cr) 
XYZ is a special standaftone deadstart routine. 


4)A copy of a deadstart panel will appear on the screen. It is 
setup for CH=13, U=s0. If you want to change any words just 
type ins: 

N=xxxx 
where N is the word number and xxxx Is the octal value. To 
change the unit numbers type in: 

52=12u 
where u is your deadstart tape physical. unit. #.- When done 
making changess hit the Left_blank key. 


5)When you are done making changes or if no changes were mades 
hit (cr). The tape should move and eventually the message 
"PROCEED" will appear on the lower left on the console. 


6Enter: CR»M29BR2=0000000000000000 
This clears the memory bounds register which is set by 
NOS deadstart. 


7TIEnters DR»eP2 
This displays the CPU registers. The SIT should be 
changing; if nots give up. 


BJAt this point the system core is toaded and can be patched. 
The commands to display and change memory are documented in 
IPNDQC. 


9)9To start the system enter: 
ss 
The CPU registers shoutd spin; if they ever stop the CPU has 
haited. It takes a while to initialize the disc and toad the 
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job templates but when or before that is done enter: 


DD 
which displays the system dayfile. Commands can now be 
entered. 
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7eO0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 


The following procedures were devetoped by the interactive 
project to assist them in interpreting dumps. They guarantee the 
procedures work if your user name is IFP3 otherwise caveat 
emptor. For more information about these proceduress contact 
Fred Bischke. 


The following dump analysis procedures are available in the 
IFP catalog: 


7e1l  EDOSIM 


This is a CCL procedure which brings an EDD dump tape on a 
specified VSN into the simulator. The procedure can be accessed 
from the IFP catalog as follows: 


getseddsim/unzifp 


beginsseddsimsvsn ( vsn is the vsn of the EDD dump tape ) 


72 _ANALEXC 


This is a Simulator INCLUDE fite which does a preliminary 
analysis of the current sitmulator exchange package ( when the 
system crashes in task servicess this will normalty be JPS ). A 
qr exc=mon or ar exczrma can be used to get into another exchange 
package before doing the inctude. The include file is 
ANALEXC/UN#®IFP. [t can be called from the simulator as follows: 


'gets,analexc/unzifp* 3; include anatexc 


{carriage return) a lone carriage return must be entered 
after an INCLUDE in order to start it up 
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7e3 SEGDUMP 


This ts a CCL procedure which calts DSDIV to dump a specified 
segment to a list file which can then be examined with an editor 
or printed. The procedure can be accessed from within the 
Simulator as follows: 

*getssegdump/unzifp" 3 "begins ssegdumpssegsiensfilesexcscpf? 

The segdump parameters are: 

seg ~- segment number in hex { default is 1 ) 
length - number of bytes to dump in hex ( default is 10000 ) 
list - name of the fist file ( default is LIST ) 
exc ~ reference exchange package { default Is JPS ) 
cpf - name of checkpoint file ( default is CPF ) 
In most cases of task services debuggings only the seg 


parameter is needed. 


7e4 ANALIOB 


This ts a CCL procedure which uses DSDIVs XEDIT and the 
Simulator to perform an analysis of ail tasks in a specified 
job. The procedure can be accessed from within the simulator as 
follows: 

*getsanal job/un=ifp’ 3; *tbeginssanail jobssegscpof? 
The anaijob parameters are: 
seg - the monitor segment which contains the exchange 
packages of the job ( 14 is the system jobs 15 is job 1 
etce ) ( default is 14 ) 
cpf - the name of the simulator file ( default is CPF ) 


After the procedure has completed, a tist of the RMA's of the 
job's exchange packages can be obtained by doing the following: 


inctude tplist 


Build Ps November 1981 


7-3 
NOS/VE Build P helpful hints 
12/22/81 


720 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 
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{carriage return) 


A traceback of all tasks in the job can be obtained by doing 
the following: 


include tblist 
(carriage return) 
include tbrun 


(carriage return) 
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8-0 ARDEN_ HILLS DEVELOPMENT LAB SUPPORT BY _ INTEGRATION 


What we have established in the tab so far is the following: 


~ A 600 tape capacity tape rack for general use. If you project 
would tike to reserve a section of this tape racks contact Tim 
McGibbon or Bonnie Swierzbin. 


- A tape and disk cabinet for storage of system support 
materials which this project will manage and keep up to date. 
{If you have been using this cabinet for unauthorized storage 
- beware. We have the key to the tock?) More will be 
published about the contents of this cabinet laters and a 
cabinet index will be posted in the fab to help tocate where 
things are supposed to be placed within the cabinet. This 
cabinet is currently tocated in the southeast corner of the 
labs is 6 fFfte 8 ine talls gray in color and with stiding 
door. 


- A microfiche reader and a metal box containing the most recent 
microfiche of the system compilation tistings and a tink map. 
These items are kept on the tabie to the right of the 
console. 


- A desk documentation rack for reference manuals and Tom 
McGee's collection of “how to" goodies. The objective is to 
have this reference information at arm's tftength of the 
consoles but it is currently on top of the two-level unit by 
the West wall. 


- At or near the consote is a smatl notebook containing the NOS 
System Programmer*s Instants NOS Application Programmer's 
Instants and the 180 Instruction codes. 


Feel free to examine and use ali of the above materials white in 
the fab. Qo not remove or_abuse any of these materialss. Please 
notify Tim McGibbon or Bonnie Swierzbin of any problems or 
deficiencies of these materials. Leave a note if we are not 
available. 
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1.0 Hardware Overview 


1.1 
1.2 


1.3 


An introduction to CYBER 180 
C180 Instant 


Model Independent General Design Specification - ARH1700 


220 NOS Reference Manuals 


2e1 


2.2 


203 
204 
205 
226 
207 
228 


XEDIT V3.0 - 60455730 

IAF V1.0 User's Guide - 60455260 

NOS Reference Manual - Vol 1s 60435400 - Vol 2» 60445300 
NOS Instant 

NOS Operators Guide - 60435600 

NOS Diagnostic Handbook 

NOS A170 ERS 


NOS A170 GID —- ARH3060 


3.0 NOS/VE Reference Documents 


3e1 


302 


323 


304 


305 


Program Interface ERS -— ARH3610 — obtained from Karen 
Rubey (482-3966) or via SES-e-TOOLDOC 


Command Interface ERS - ARH3609 - obtained from Karen 
Rubey (462-3966) or via SES.~TOOLDOC 


NOS/VE Procedures and Conventions ~- SESDOQ1O - obtained by 
SES.-TOOLDOC 


Listing of all NOS/VE Modules ~ obtained by 
SESsDEVILeLISTNVE. See Integration Procedures Notebook 
for details. 

NOS/VE Internal Interface Maintenance Procedures 


Memo available from $.C. Wood. 
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Obtained by: 
Acquires TIPNDOC/UN=DEV1. SESsPRINTsIPNDOAC. 
4.0 Tools Reference Documents 
4e1 CYBIL Interactive Debugger - ARH3142 
4.2 SES User's Guide - ARH1833 
4.3 CYBIL Specification —- ARH2298 
424 €180 Assembler ERS ~ ARH1693 
4.5 Simutator ERS - ARH1729 
4.6 VEGEN ERS — ARH2591 
407 VELINK ERS - ARH2816 
4.8 Simulated 1/0 ERS - ARH3125 
4.9 Object Code Utilities ERS ~- ARH2922 
4.10 CYBIL Implementation Dependent Handbook - ARH3078 
4-11 CYBER 180 INTERACTIVE DEBUG External Reference 


Specification and Users Guide - $4028 
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